home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / utils / spr_cut / cutter.doc < prev    next >
Text File  |  1995-03-12  |  5KB  |  120 lines
  1.              ┌──────────────────────────────────────────────────┐
  2.              │          Sprite Cutter Utility v2.0              │██
  3.              │                      by                          │██
  4.              │               gaggi@cs.unibo.it                  │██
  5.              └──────────────────────────────────────────────────┘██
  6.                ████████████████████████████████████████████████████
  7.  
  8. Hello,
  9. I am proud to show all the boys out there my first serious work.
  10. It's written half in C and half in Assembly, I hope that it will be
  11. useful to all the people who are interested in game programming as I am.
  12. I have downloaded several sprite editors and sprite cutters from various ftp
  13. sites, but I could not never find what I was looking for: a powerful graphic
  14. editor with animation capabilities so I decided to write something myself.
  15.  
  16. The utility I have written cuts from a PCX image file created by a graphic
  17. package, such as Deluxe Paint, sprite bitmaps and it also gives the
  18. possibility to play simple animation in order to see if the sprites are enough
  19. cool.
  20.  
  21. HOW TO USE THIS SPRITE CUTTER
  22. ----------------------------
  23. NOTE: A mouse is needed to run the program!
  24.  
  25. Starting up the program attempts to load the PCX file given on command line,
  26. then it enters the cut mode. If no file name is given on command line the
  27. program enters the cut mode but you can't cut anything without loading a
  28. picture.
  29.  
  30. To cut a sprite you must press the left button of the mouse.
  31.  
  32. All cuts are saved in a file .LST which contains the source picture name and
  33. all the positions and the sizes of the cuts. Here follows .LST format:
  34.  
  35. BYTES        
  36. 0  - 24       source picture name
  37. 25 - 30       1st cut datas
  38. 31 - 36       2nd cut datas              
  39. ... and so on.
  40.  
  41. Here is the format of cut data:
  42. BYTES
  43. 0 - 1         Cut x coordinate
  44. 2 - 3         Cut y coordinate
  45. 4             Cut x size
  46. 5             Cut y size
  47.  
  48. The bitmaps of sprites are saved in a file .SPR. Its format is the following:
  49.  
  50. BYTES
  51. 0            1st Bitmap x size
  52. 1            1st Bitmap y size
  53. 2 ...        (x size)*(y size) bytes of bitmap datas
  54.  
  55. ...          2nd Bitmap x size
  56.              2nd Bitmap y size
  57.              (x size)*(y size) bytes of bitmap datas
  58. ... and so on.
  59.  
  60. MENUS
  61. The program has a main menu activated by the right button of mouse.
  62. Here is the menu and a few explanations:
  63.  
  64. ┌────────────────┐
  65. │ Main           │
  66. │┌──────────────┐│
  67. ││ Source       ││ <- Choice this voice if you want to load a PCX file
  68. ││ Sprite ...   ││ <- Sprite subMenu
  69. ││ Size   ...   ││ <- Sprite size subMenu, use it to change cut sizes
  70. ││ Quit         ││ <- Quits
  71. │└──────────────┘│
  72. └────────────────┘
  73.  
  74. The Sprite subMenu
  75. ┌────────────────┐
  76. │ Sprite         │
  77. │┌──────────────┐│
  78. ││ Load LST     ││ <- Load new cut datas
  79. ││ Save LST     ││ <- Save current cut
  80. ││ Animate      ││ <- Perform little animations
  81. ││ Save SPR     ││ <- Save sprite bitmaps
  82. │└──────────────┘│
  83. └────────────────┘
  84.  
  85. The animation procedure is very simple. First of all you have to choose
  86. animation frames, to select a frame just click on it with the left button
  87. of the mouse. You can select a maximum of 10 frames. Then you'll be asked
  88. to type the animation sequence and the animation will start!
  89.  
  90. INPUT BOXES
  91. Sometimes you'll be asked to enter datas (such as file name and so on).
  92. All the input is done by these windows, they are very simple to use.
  93. If you want to cancel the input procedure just press ESC.
  94.  
  95. MESSAGE BOXES
  96. They are used to display messages and to confirm operations. 
  97. To cancel message box just press any of the mouse buttons or press a key.
  98. If a yes/no answer is required you have to press 'y' or 'n' keys to cancel
  99. the message box.
  100.  
  101. And this is all! Feel free to send me any comment via e-mail or snail-mail.
  102. If you want I will provide you more information about the implementation
  103. and if you required it I will give you full source code, but please don't use
  104. it for commercial purposes without my permission!
  105.  
  106. One more thing: the program IS NOT bug-free, please report me any kind of
  107.                 malfunctioning.
  108.  
  109. --------------------------------------------------
  110. Nicola Gaggi
  111. University of Bologna
  112.  
  113. e-mail: gaggi@cs.unibo.it
  114. WWW page: http://www.cs.unibo.it/~gaggi
  115. snail-mail: Nicola Gaggi
  116.             Via Gramsci 23
  117.             40050 Quarto Inferiore
  118.             BOLOGNA - ITALY
  119. --------------------------------------------------
  120.